Waverider Systems
http://www.WaveriderSystems.com

Perlshop 4 Random Catalog Page Plugin
Version 1.0


This plugin requires Perlshop 4.2.06 or later.  

--------------------------------------------------------------------------------------
Installation Procedure:
1.	Place the ps_plugin_random.pl file into the same web server directory as your perlshop.cgi file.

2.	Give the ps_plugin_random.pl file the same file permissions as your perlshop.cgi file.

3.	Add the Random Catalog Page plugin to the plugin registration table in your ps.cfg file.

Example plugin registration table before adding the random catalog page plugin:
# Plugin modules.  See the external documentation for details.
%plugins =
(
	# Calendar example plugin
	'calendar'  => 
	{
		'program'	=> 'ps_plugin_gencal.pl'
	}
);


Example plugin registration table after adding the Random Catalog Page plugin:
# Plugin modules.  See the external documentation for details.
%plugins =
(
	# Calendar example plugin
	'calendar'		=> 
	{
		'program'	=> 	'ps_plugin_gencal.pl'
	},

	# Random Catalog Page plugin
	'random_page'	=>
	{
		'program'	=>	'ps_plugin_random.pl',
	}
);


--------------------------------------------------------------------------------------
Creating your ps_random.txt file:

Overview:
The Random Catalog Page plugin uses a file called 'ps_random.txt' in order to operate.  This file is simple text, and contains the names of the catalog pages you want to make available to this plugin.  Any text editor can be used to create this file.  If you are creating this file on your desktop, you will need to be sure it is transfered to your web server in ASCII mode.


File Layout:
Each line of this file contains the name of one catalog page file.  If you have a standard Perlshop installation, then each line of the file will have the following form:

catalog/somepage.html

If you have placed your catalog directory someplace else on your web server, you will need to specifiy the full path name to the catalog page file:

/home/myaccount/public_html/catalog/sompage.html


--------------------------------------------------------------------------------------
Installing your ps_random.txt file:

Place the ps_random.txt file in the same directory as the ps_plugin_random.pl file.
Give the ps_random.txt file the same file permissions as the ps.cfg file.


--------------------------------------------------------------------------------------
Using the Random Catalog Page plugin:

This plugin is intended to be used via standard plugin action call.  Please see the plugin documentation at Waverider Systems for details and examples.